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EDS Commands 



This document describes the Monitor and Control Interface commands for the StarGuide Digital EDS plug-in module. 
As the command list grows or changes this document will be updated. Several commands are considered "debug" 
commands and can not be accessed unless the debug command is issued with the correct password. 

The foilowing list displays the current set of commands on the EDS Card board. This also happens to be the output of 
the HELP command. 



ADDR 
HELP 
EO 
MC 

REBOOT 
STATS 

TIME [, value] 

TIME ZONE [ , value , name] 

DIR [path] 

SCHED 
VER 



- Addressing Settings 

- Usage Info 

- EO Port Settings 

- M&C Config 

- Software Reboot 

- Board Statistics 

- Calandar Time 

- Local timezone 

- Show directory 

- Current schedule 

- Software Version 



If the unit has is in debug mode the following commands can also be accessed: 



DEBUG COMMANDS: 



COMMUNITY 



SNMP Community Settings 



HDLC 
HOST 
IGM? 

MR [address] [, length] 

MW <address>, <value> [ , value, 



Settings for FTP download 
HDLC Settings 

Communicate with Receiver Host 
IGMP Settings 
Memory Read 
Memory Write 



- Non-volatile Memory Commands 



RCV 

SYSTEM 



- Receiver Settings 

- SNMP System Variable Settings 



ADDR 



The ADDR command is used to set or query the addressing modes used in the In-Band Control stream. The 
types of addressing are the same used in the StarGuide II receiver. Because these commands are used 
primarily for network control purposes, only a limited subset of commands is shown to the user (using ADDR 
SHOW). The list of options shown the user is as follows: 



ADDR SER1AL_NUMBER 
ADDR SHOW 



This form of the command queries the serial number 
of the ethernet card. 

This form of the command shows the current address 
settings. 



The ADDR command takes the following forms which can be used for network control: 

ADDR NID[,value] This form of the command queries or sets the 

Network ID for the ethernet card. 

ADDR LID,<index>[,value] (index range 0..15) This form of the command sets or queries the logical 

ID settings for the ethernet card. 

ADDR SID,<index>[, value] (index range 0..I5) This form of the command sets or queries the slot ID 

settings for the ethernet card 

COMMUNITY 

The community command is used to set or query the community strings used by SNMP, This command is a debug 
command and comes in the following forms: 



COMMUNITY PUBLIC[,"string",index] 



COMMUNITY PRIVATE[,"string M ] 



COMMUNITY SHOW 



To set the public strings used for SNMP GET 
commands, the string must be less than 256 characters 
and the index should be 0 for the string that has access 
to the entire MIB II database and 1 for the string that 
only has access to the ICMP portion of the database. 
The string should be surrounded by double quotes as 
shown. 

To set the private community string used for SNMP SET 
commands, the string must be less than 256 characters. 
The string should be surrounded by double quotes as 
shown. 

Shows the current community strings. For example, the 
following display shows the default values when 
queried. 



>COMMUNITYSHOW 



PUBLIC: 
[0] public 
[1] icmp 



PRIVATE: 
private 



DEBUG 



The DEBUG command is used to enable various debug modes on the ethernet card. If the debug mode has not 
been turned on then all of the following commands will return an ERROR response (except DEBUG SDN 
which turns debug mode on). The following forms of the command are used: 



DEBUG SDN 
DEBUG OFF 
DEBUG SHOW 



Turns the debug mode on. 

Turns ail debug modes off. 

Show the current setting for the debug modes. 



DIR 



The DJR command is used to display the contents of the Flash Memory Storage of the EDS Card card. This 
command takes an optional parameter that is the pathname on the drive to list the contents of. If no path is 
given the root directory is assumed. The forms of the DIR command are shown below: 

DIR Display the contents of the root directory 

DIR path Display the contents of the directory specified by path 

A sample display from a DIR command is shown below: 

>dir 



MOM DEC 31 17:00:00 1979 
MOM DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 1979 
MOM DEC 31 17:00:00 1979 
MOW DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 1979 
TUE OCT 19 14:21:12 1999 
TUE SEP 07 09:27:50 1999 
MON DEC 31 17:00:00 1979 
WED OCT 20 18:19:10 1999 
THU AUG 26 19:22:32 1999 
MON DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 1979 
MON DEC 31 17:00:00 197 9 
MON DEC 31 17:00:00 1979 



98220 TEST.MP2 
486912 SPOT.MP2 

969 DEFAULT . HTM 
135 TEST. HTM 
112640 TEST. TXT 
<DIR> TEMP 

5120 NVRAM. BAK 
997 TITLES . OLD 
719 PACKAGE . HTM 
874 TITLES. BAK 
599729 TEST . JPG 
32646 LOGO . GIF 
349 AUDIO . GIF 
324 DATA. GIF 
417 IMAGE . GIF 
398 PACKAGE .GIF 
324 PROG. GIF 
336 TXT. GIF 



TestAudioSpot 
MyAudio 



MON DEC 31 17:00:00 1979 


323 VIDEO. GIF 




MON DEC 31 17:00:00 1979 


1909 SEARCH. HTM 




TUE OCT 19 14:21:14 1999 


5120 NVRAM. CFG 




WED OCT 20 18:19:26 1999 


874 TITLES. CFG 




TUE OCT 19 14:37:52 1999 


2748 003ED757. 


LiArx\ljoo . LUH NOtcS xyyy/LU/i.0 


TUE OCT 19 14:37:56 1999 


1673 003ED758. 




TUE OCT 19 14:38:02 1999 




MXPRESS LOGO NAVYBLUE 


TUE OCT 19 14:40:44 1999 


717 omrn7fi£ 


ABC Predemo test 


TUE OCT 19 14:41:12 1999 


£. y \j ^ y 4 UU JLU r o ' • 


ANTONIO BANDERAS 


TUE OCT 19 14:41:44 1999 


29888^ Q03ED768 




TUE OCT 19 14:41:52 1999 


.LOU UUOJjU / 03 . 


TEST 


TUE OCT 19 14:41:58 1999 


17726 003ED76A 




WED OCT 20 16:09:36 1999 




94 4 70 


WED OCT 20 16:09:42 1999 


u Jl UU Jul/ i uL • 


MUKE FROM THE FAQ 


WED OCT 20 16:10:36 1999 




QCO'I 
OJfli 


WED OCT 20 16:10:54 1999 




JEWEL ON WHY 


MON DEC 31 17:00:00 1979 


1410 ^PHFn HTM 




MON DEC 31 17:00:00 1979 


919 CONFIG. HTM 




MON DEC 31 17:00:00 1979 


911 HELP . HTM 




WED OCT 20 18:19:08 1999 


2749 003ED77D. 


94471 


WED OCT 20 18:19:12 1999 


1312 003ED77E. 


HOW DO I TRACK A PACKAGE 


MON DEC 31 17:00:00 1979 


1263 NEW. GIF 





39 files, 2169026 bytes used, 145313792 bytes free 



E0 



The E0 command (formerly the IP command) is used to configure or monitor the ethernet port (E0) of the card. This 
command has several sub-commands that can be used to configure the card's behavior to packets being transferred 
from the HDLC port to the ethernet port. The configuration of these parameters can only be made if the unit is in 
debus mode. 



E0 IP_ALLOW[,address,mask] 
E0 IP_ALLOW,<ANY,NONE> 
E0 1P_ADDR[,addr] 



Queries or sets the addresses allowed to pass to the ethernet port. Up to 8 
address,mask pairs can be entered. If the unit is not in debug mode, this 
sub command can only be queried. 

The ANY option allows all IP destination addresses to be passed from the 
HDLC port to the ethernet port. The NONE option will prevent all IP 
packets from being passed from the HDLC port to the ethernet port. 
This command sets or queries the IP address of the ethernet interface. 
After and changes have been made the REBOOT command must be 
issued for the new changes to take affect. 



EO IP_SUBNETMASK[,addr] This command sets or queries the IP address subnet mask of the ethernet 

interface. After and changes have been made the REBOOT command 
must be issued for the new changes to take affect. 

EO IPj3ATEWAY[,addr] This command sets or queries the IP address of the ethernet interface's 

default gateway. Any commands coming through the HDLC port to 
addresses that can not be resolved locally are forwarded to the default 
gateway. After and changes have been made the REBOOT command 
must be issued for the new changes to take affect. 

EO IP_ALIAS_ADDR[,addr] This command sets or queries the IP alias address of the ethernet 

interface. 

EO IP_ALIAS_ADDR,DELETE This command deletes the IP alias address of the ethernet interface. The 

alias is a secondary IP address for the ethernet interface. 

EO IP_ALIAS_NETMASK[,mask] This command sets or queries the IP alias netmask of the ethernet 

interface. 

EO SHOW Display the current settings for the ethernet interface. 



FTP 



The FTP command is protected by the debug password. The FTP command is used to setup and initiate an 
FTP software download to flash memory. The items that need to be set prior to initiating an FTP download 
are the FTP server IP address, the username, and user password in order to access the FTP server. These 
settings are stored in non-volatile memory. 



FTP IP_ADDR[,address] 
FTP USER[,string] 
FTP PASSWORD[,string] 
FTP GET,filename 



FTP GET RCV,fiIename 



FTP GET_RCV,filename,HIF 



FTP SHOW 

IP_ADDR: 192.168.3.168 
USER: grasche 
PASSWORD: newguy 



Sets the IP address of the FTP server 
This is the user string used to log into the FTP server. 
Th is is the password used to log onto the FTP server. 
This command initiates a download of the file specified. Make sure that 
the filename includes the entire path to the file. For example 
"/incoming/v00I3.ftp". The FTP process will report status indicators 
indicating progress of the download. A "." will be printed on every 
download block to indicate that the download is in process. 
This command initiates a download of the file specified for the StarGuide 
Receiver. The downloaded file is sent through the AUX1 port to the 
receiver. Make sure that the filename includes the entire path to the file. 
For example "/incoming/v0013.ftp". The FTP process will report status 
indicators indicating progress of the download. A "." will be printed on 
every download block to indicate that the download is in process. 
This command initiates a download of the file specified for the StarGuide 
Receiver. The downloaded file is sent through the host interface port to 
the receiver rather than the AUX1 port. In order for this type of download 
to work, the receiver must have the correct host interface code (Clear 
Channel Code VI. 16 or later or CP Code V3.72 or later). Make sure that 
the filename includes the entire path to the file. For example ^ 
'Vincoming/vOOlS.ftp" The FTP process will report status indicators 
indicating progress of the download. A "." will be printed on every 
download block to indicate that the download is in process. 
Display the FTP parameters. The output is shown below. 



HOST 

The HOST command is protected by the debug password. The HOST command allows the user to 
communicate to the host receiver. There are two communication paths available to communicate with the 



receiver: internally through the host interface or externally through a cable from the AUX1 port of the 
ethernet card to the M&C port of the receiver. The first option, internal communication, requires the clear 
channel receiver code VI. 16 or higher. The second option works with any version of receiver code but does 
require an external cable. The two forms of the HOST command are shown below. 

HOST string This command sends the string specified to the receiver through the 

internal host interface. Note that the string represents a command to 
the receiver and as such MUST be in capital letters. If the string 
contains a comma then it MUST be surrounded by double quote (") 
characters. 

HOST A UX1, string This command sends the string specified to the receiver through the 

external AUXI connector. Note that the string represents a command 
to the receiver and as such MUST be in capital letters. If the string 
contains a comma then it MUST be surrounded by double quote (") 
characters. 



HDLC 

The HDLC command is protected by the debug password. The HDLC command controls the incoming data 
from the StarGuide II receiver. The data is received over the receiver backplane. The data is ethernet data 
packets encapsulated in an HDLC stream. One of the other parameters of the HDLC command is the IBS 
channel IP address and port number. This address (along with the associated port) determines which packets 
are designated as "in-band signalling". 



Sets the debug level for the HDLC 
processing block. 

Sets the HDLC software driver debug level. 
Enables the reception of data from the 
receiver. 

Set the In-Band Control Channel IP address. 
Sets the port used for the IBS stream. 
Clears all HDLC statistics. 
Display HDLC parameters and counters. 
The output is shown below: 



>HDLC SHOW 

debugLevel 0 
cirvDebug FALSE 
enable TRUE 

conf ig. ibsIpAddr 239.255.0.1 f OxEFFFOOOl ) 
conf ig. ibsUdpPort 2002 
isrCount 0 

Glitch on RX 0 

Flag Status 0 

Rx Frame 0 

Busy Condition 0 

Rx Buffer 0 
Rx DPLL Error 0 
Rx Length Error 0 
Rx Nonalign FrameO 
Rx Abort 0 
Rx CRC Error 0 
Rx Overrun 0 
discardFrameCnt 0 



HDLC DEBUG_LEVEL[,0|1|2] 

HDLC DRV_DEBUG[,TRUE|FALSE] 
HDLC ENABLE[,TRUE|FALSE] 

HDLC IBS_IP_ADDR[,value] - 

HDLC IBS_UDP_PORT[, value] - ( 1 ..8000) 

HDLC STATISTICS_CLEAR 

HDLC SHOW 



IGMP 



crcErrorCnt 0 
abortErrorCnt 0 
if aceErrorCnt 0 

The values of the counters increase as IP traffic is received from the SGII receiver. 



The IGMP command is also hidden behind the debug password. The IGMP command is used to configure the 
ethernet card's behavior in the presence of an IGMP network. This commands options are shown below. 

IGMP DEBUG[,TRUE|FALSE] 



Enables the debug mode of the 
IGMP process. 

Enables the card's IGMP handling. 
In IGMP mode, this command 
enables the card's query mode. 
Sets the query interval in query 
mode (in 1/10 of second). 
Sets the response timeout value (in 
1/10 of a second). 
Base address of the IGMP address 
block. 

IGMP IP_ADDR_MASK[,vaIue] - (0xFFFF0000..0xFFFFFFFF) Sets the mask for the block which 

determines the size of the address 
block. 

Query if a particular IP address is 
joined or not. 

Display the IGMP settings. The 
response is shown below. 



IGMP ENABLE[,TRUE|FALSE] 

IGMP QUERIER_ENABLE[,TRUE|FALSE] 

IGMP QUERY_INTERVAL[, value] - (100..2500) 

IGMP QUERY_RESPONSE_INTERVAL[, value] - (10..255) 

IGMP IP_ADDR_BASE[,vaiue] - (0xE0000000..0xEFFFFFFF) 



IGMP GROUPJvtEMBER,<ip_addr> 
IGMP SHOW 



>IGMP SHOW 
debug 
querier 
enable 

querierEnable 
querylnterval 



TRUE 
TRUE 
TRUE 
TRUE 

600 (1/10 seconds) 



queryResponselnterval 100 (1/10 seconds) 



ipAddrSase 
ipAddrMask 



239.255.0.0 (OxEFFFOOOO) 
OxFFEFOOOO 



The MC command is used to set the parameters of the monitor and control RS-232 interface. Currently only 
the baud rate can be set although the parity, data bits, and stop bits will be added to this command in the 
future. 

MC LOGMSG,<TRUE|FALSE> 

MC TTY_BAUD_RATE,<value> (range 9600..38400) Sets the baud rate to the specified setting. 
MC SHOW Displays the current settings for the M&C port. 



PING 



The PING command is used to check Ethernet connectivity from the EDS Card card to another IP based 
device. The PING command will send out an ICMP echo request message to the specified IP address. The 



command will display the results of the ping messages (either success or failure). If the pings are successful, 
time results will be displayed. The PING command comes in the following forms: 



PING ipAddress<,numPings> Where the ipAddress can either be a dot 
notation address or a hex number and the numPings represents the number 
of pings to send. The numPings must be greater than 0. The following 
results show a successful ping followed by an unsuccessful ping. 

>ping 192.168.3.1 



taskSpawn ok 

>PING 192.168.3.1: 56 data bytes 

64 bytes from sd-f irewall . starguidedigital . com (192.168.3.1): icmp_seq=0. 
time=4. ms ~~ 
64 bytes from sd-f irewall . starguidedigital . com (192.168.3.1): icmp_seq=l. 
time=2. ms 

64 bytes from sd-f irewall . starguidedigital . com (192.168.3.1): icmp_seq=2. 
t ime=2 . ms 

192.168.3.1 PING Statistics 

3 packets transmitted, 3 packets received, 0% packet loss 
round-trip (ms) rain/avg/max = 2/2/4 



>ping 100.1.1.1 



taskSpawn ok 

>PING 100.1.1.1: 56 data bytes 
no answer from 100.1.1.1 



The NV command is a debug command. The NV command is used to access or display various non-volatile 
memory locations or structures. Currently it is used to store an event log so all of the options of the command 
revolve around the log. In the future this command may be converted to a LOG command with various 
options. 

NV DB_CLEAR Clears the entire non-volatile memory database. 

NV LOGJ3LEAR Clears the event log. 

N V LOG_SHO W[,index] Displays the contents of the event log. 



RCV 

The RCV command is used to configure or query critical parameters of the receiver. This command 
communicates with the receiver via the internal host interface. Thus, the receiver must being running Clear 
Channel Code Version LI 6 code or newer. The following list shows the options available with the RCV 
command. Each command option indicates a command that is sent to the receiver. For details on any of the 
receiver commands, see the StarGuide H User's Manual. 



RCV RF[,frequency] - (920000..2050000) 
RCV DR[,data_rate] - (5 12000.. 8 192000) 
RCV VR[,viterbi_rate] - (3. .4) 
RCV CLR[,clr_mode] - (0.. 1 ) 
RCV EB 

RCV AG 



RCV SS 



RCV SF 



RCV REV 



RCV SHOW 



>rcv show 



RF: 


985000 


OR: 


6144000 


VR: 


3 


CLR: 


1 


£B: 


7.0 


AG: 


127 


SS: 


0x00000000 


SF: 


OxOOOOOCOO 


REV: 


1.16,8, 160 



The RF queries or sets the receiver's L-Band frequency in 

kHz. Valid values are shown in parentheses. 

The DR queries or sets the receiver's data rate in bits per 

second. Valid values are shown in parentheses. 

The VR command sets or queries the Viterbi decoder rate of 

the receiver. Valid values are shown in parentheses. 

The CLR command sets or queries the Clear Channel Mode 

of the receiver. Valid values are shown in parentheses. 

The EB command queries the current Eb/No reading of the 

receiver in lOths of a dB. The higher the number, the better 

the signal strength. 

The AG command queries the current AGC reading on the 
receiver. The higher this value is the less input signal level 
there is at the input of the receiver. This value ranges from 
0 to 255 and should be kept as near to 128 as possible when 
configuring the receiver. 

The SS queries the current status of the receiver. This value 
represents a sum of the individual status bits currently 
active. A value of 0 indicates no errors are currently active. 
See the StarGuide II User's manual for the bitmap values. 
The SF queries the fault history of the receiver. This value 
represents a sum of the individual status bits that have been 
activated since the last time they were cleared (using the SF 
0 command through either the HOST or HOST AUX I 
commands). A value of 0 indicates no faults have occurred. 
See the StarGuide II User's manual for the bitmap values. 
The REV command queries the current software version 
running in the receiver. This command shows the code 
versions of the motherboard, the demodulator, and the DSP 
code. 

The RCV SHOW command displays the current values of 
the receiver parameters that are queried. A parameter is 
queried every 2 seconds and the parameters are queried 
sequentially. The output of this command looks something 
like the following. 



REBOOT 

The REBOOT command is used to perform a soft boot. The command comes in one form: 
REBOOT <arg> Where arg can be either 

0: This type of boot causes the system to go through the normal bootup 

sequence but memory is not cleared. 

1 : This type of boot causes the reboot to pause at the boot prompt so the 
user can change any boot parameters. Memory is not cleared in this type of 
boot. 



2: This performs a normal boot but memory is cleared. This is the default 
if arg is not specified. 

SCHED 

The SCHED command is used to display the scheduler's current scheduled events. The command comes in 
the following forms: 



SCHED SHOW Displays the currently active schedules, if any. 

SCHED PURGE Delete any exisiting schedule. 

SCHED ADD,dT,rly,fidO[,fIdN] Add an event to the schedule. 
The dT parameter indicates an event window time in which the 
relay specified by rly must occur. If the relay is activated 
during the active window then the file or files specified by the 
fidO through fidN parameters are played from the flash 
memory disk. If multiple files are specified they are played 
back to back starting from the first file through the last file. 



STATS 

The STATS command is used to display various bandwidth statistics kept on the board. The statistics include 
both the ethernet port and the hdlc port. 

STATS_CLEAR Clears the statistics. 

STATS SHOW Shows the current statistics. An example of the parameters displayed are 

shown below. The statistics are kept from the last time they were cleared. The 
bandwidth statistics show the average bandwidth over the last 5 seconds. 

>STATS SHOW 

SATELLITE: INTERFACE (sO) 

10 packets received; 0 packets sent 
0 input errors; 0 output errors 
1065 bytes received 

504 bps (average bandwidth) received 

Average satellite packet size is 106 

ETHERNET INTERFACE (eO) 

625 packets received; 439 packets sent 
0 input errors; 0 output errors 
600 collisions 

3 packets routed from sO 
84 9 bytes routed from sO 

4 52 bps (average bandwidth) routed from sO 
Average packet size routed from sO is 283 

136 seconds since the statistics were cleared 



SYSTEM 

The system command is used to set or query the SNMP system table strings. This command is a debug 
command and comes in the following forms: 



SYSTEM CONTACT[, "string"] 



To set the contact string, the string must be less than 256 
characters. The string should be surrounded by double 
quotes as shown. 



SYSTEM LOCATIONLVring"] 



To set the location string, the string must be less than 
256 characters. The string should be surrounded by 
double quotes as shown. 

This command can either query the current SNMP 
description string or re-initialize it. The re-initialization 
is only needed once after upgrading the code from 
versions 5-7 to version 8 or newer because the format of 
the string saved in flash memory was changed. If this is 
not done the description in the SNMP will indicate both 
the previous software version AND the new one. 



SYSTEM DESC[,INIT] 



SYSTEM SHOW 



Display the current settings for the SNMP System 
tables. The output of this command is shown below 
with the card's default strings. 



>SYSTEM SHOW 
LOCATION: 

San Diego, CA 92 12 1 (619)452-4920 
CONTACT: 

Starguide Digital Networks 
TIME 

The time command is used to set or query the system time. The StarGuide receiver will set the time based on 
the network timestamp. An example of the query response is shown below. 

940542936JHUOCT21 14:55:36 1999 PDT (GMT-7) 

The time command can also be used to set the current time zone for the EDS Card card since the time is sent 



The VER command is used to query the current software version. The query response includes the software 
version, the date and the time the code was built. An example of a query is shown below. 



in GMT. 



VER 



0.0.2,Jan 22 1997,16:35:50 



